/* Soubor je ulozen v kodovani UTF-8.
 * Kontrola kódování: Příliš žluťoučký kůň úpěl ďábelské ódy.
 */
package cz.pecinovsky.english.pojj.adv_demo.gui._02_panely;

import cz.pecinovsky.english.pojj.adv_framework.game_gui.IGameG;
import cz.pecinovsky.english.pojj.adv_framework.game_gui.IUIG;

import cz.pecinovsky.english.pojj.adv_framework.game_txt.IGame;

import cz.pecinovsky.english.pojj.adv_framework.test_util._Test_101;

import java.awt.BorderLayout;
import java.awt.Point;

import java.awt.event.ActionEvent;
import java.awt.event.ActionListener;

import javax.swing.JFrame;
import javax.swing.JTextArea;
import javax.swing.JTextField;



/*******************************************************************************
 * Instance třídy {@code GUI_01} představují
 * superjednoduché grafické uživatelské rozhraní umožňující hrát hry
 * vyhovující podmínkám rámce (frameworku) definovaného v balíčku
 * {@code cz.pecinovsky.english.pojj.adv_framework.game_txt},
 * tj. textové hry vyhovující požadavkům minulého semestru.
 * <p>
 * Oproti verzi {@code GUI_01} se změnilo:
 * <ul>
 *   <li>V zájmu zestručnění a zpřehlednění zdrojového textu byly odebrány
 *     některé komentáře vysvětlující použité obraty,
 *     které by měy být zkušenějším uživatelům jasné.
 *     </li>
 *   <li>Z GUI bylo odstraněn atribut {@code button} reprezuentující tlačítko, 
 *     které sloužilo pouze k demonstraci některých funkcí component GUI.
 *     </li>
 *   <li>Bylo (alespoň formálně) implementováno rozhraní {@link IGameG},
 *     tj. byly definovány všechny metody deklarovné v tomto rozhraní.
 *     </li>
 * </ul>
 *
 * @author    Rudolf PECINOVSKÝ
 * @version   0.00.000
 */
public class GUI_02_0 implements IUIG
{
//== KONSTANTNÍ ATRIBUTY TŘÍDY =================================================

    /** Souřadnice, na které se aplikační okno přesune po spuštění GUI.
     *  To má smysl především při zobrazování na sekundárním monitoru. */
    private static final Point POINT_0 = new Point(0, 0);       //(-600, 0);

    /** Konstanty používané při formátování vystupujícího textu. */
    private static final String
            PŘED_PŘÍKAZEM = "\n=============================================\n",
            ZA_PŘÍKAZEM   = "\n---------------------------------------------\n";



//== PROMĚNNÉ ATRIBUTY TŘÍDY ===================================================
//== STATICKÝ INICIALIZAČNÍ BLOK - STATICKÝ KONSTRUKTOR ========================
//== KONSTANTNÍ ATRIBUTY INSTANCÍ ==============================================

    /** Hra, která bude hrána prostřednictvím tohoto GUI. */
    private final IGame game;

    /** Aplikační okno spuštěného GUI. */
    private final JFrame appWindow = new JFrame("První okno");

    /** Komponenta, do které je zapisován text
     *  informující uživatele o průběhu hry. */
    private final JTextArea outputArea = new JTextArea(30, 45);

    /** Vstupní textové pole, do nějž uživatel zapisuje své příkazy. */
    private final JTextField inputField = new JTextField(25);



//== PROMĚNNÉ ATRIBUTY INSTANCÍ ================================================
//== PŘÍSTUPOVÉ METODY VLASTNOSTÍ TŘÍDY ========================================
//== OSTATNÍ NESOUKROMÉ METODY TŘÍDY ===========================================

//##############################################################################
//== KONSTRUKTORY A TOVÁRNÍ METODY =============================================

    /***************************************************************************
     * Vytvoří novou instanci GUI,
     * která hned odstartuje komunikaci s hrou zadanou v parametru.
     *
     * @param game Hra, se kterou bude GUI komunikovat
     */
    public GUI_02_0(IGame game)
    {
        this.game = game;

        appWindow.setVisible(true);

        //Následující posunutí má smysl pouze při zobrazování
        //na druhém monitoru, který je umístněn vlevo od hlavního
        appWindow.setLocation(POINT_0);

        appWindow.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
        appWindow.add(outputArea, BorderLayout.CENTER);
        appWindow.add(inputField, BorderLayout.SOUTH);

        outputArea.setEditable(false);
        inputField.addActionListener(new TxfListener());

        String odpověď = game.executeCommand("");
        outputArea.setText(odpověď + "\n");

        appWindow.pack();
    }



//== ABSTRAKTNÍ METODY =========================================================
//== PŘÍSTUPOVÉ METODY VLASTNOSTÍ INSTANCÍ =====================================

    /***************************************************************************
     * Vrátí jméno autora scénáře ve formátu <b>PŘÍJMENÍ Křestní</b>,
     * tj. neprve příjmení psané velkými písmeny a za ním křestní jméno,
     * u nějž bude velké pouze první písmeno a ostatní písmena budou malá.
     *
     * @return Jméno autora/autorky programu ve tvaru PŘÍJMENÍ Křestní
     */
    @Override
    public String getAuthor()
    {
        //TODO Operace ještě není implementována
        throw new UnsupportedOperationException("Prozatím neimplementováno");
    }


    /***************************************************************************
     * Vrátí x-name autora/autorky programu zapsané velkými písmeny.<p>
     * X-name má tvar <b>{@code XPPPK99}</b> nebo <b>{@code XPPPK999}</b>,
     * kde<br>
     * <ul>
     *   <li><b>{@code PPP}</b> zastupuje první tří písmena příjmení autora(ky)
     *      zapsaná velkými písmeny, </li>
     *   <li><b>{@code K}</b> zastupuje první písmeno křestního jména a </li>
     *   <li><b>{@code 99}</b>, resp. <b>{@code 999}</b> zastupují číslice
     *      přiřazené systémem, pomocí nichž se rozsliší studenti(ky)
     *      s předchozími znaky shodnými.
     * </ul>
     *
     * @return X-name autora/autorky programu
     */
    @Override
    public String getXNAME()
    {
        //TODO Operace ještě není implementována
        throw new UnsupportedOperationException("Prozatím neimplementováno");
    }


    /***************************************************************************
     * Spustí komunikaci mezi zadanou hrou a danou instancí GUI
     * mající na starosti komunikaci s uživatelem.
     * <p>
     * Metoda před pokusem o spuštění zadané hry nejprve zkontroluje,
     * že pomocí daného GUI není akutálně hrána žádná hra
     * a že ani zadaná hra není rozehrána. V opačném případě vyhodí výjimku.
     * <p>
     * Tato verze ještě není plnohodntou implementací,
     * protože je schopna obsluhovat i hry implementující rozhraní
     * a proto není pravda, že: "<i>nejprve však zkontroluje,
     * že zadaná hra je ve skutečnosti instancí rozhraní {@link IGameG},
     * protože jiné neposkytují metody, které grafické UI očekává</i>".
     *
     * @param game Hra, kterou ma dané UI spustit
     * @throws IllegalArgumentException
     *         Existují důvody, které brání spuštění zadané hry
     */
    @Override
    public void startGame(IGame game)
    {
        //TODO Operace ještě není implementována
        throw new UnsupportedOperationException("Prozatím neimplementováno");
    }


    /***************************************************************************
     * Spustí komunikaci mezi implicitní hrou a danou instancí
     * mající na starosti komunikaci s uživatelem.
     */
    @Override
    public void startGame()
    {
        //TODO Operace ještě není implementována
        throw new UnsupportedOperationException("Prozatím neimplementováno");
    }


    /***************************************************************************
     * Zpracuje příkaz předaný v parametru jako by byl zadán standardním
     * postupem z klávesnice. Metoda umožňuje testovat reakce daného
     * uživatelského rozhraní na příkazy zadávané z klávesnice.
     *
     * @param command Zadávaný příkaz
     */
    @Override
    public void executeCommand(String command)
    {
        //TODO Operace ještě není implementována
        throw new UnsupportedOperationException("Prozatím neimplementováno");
    }



//== OSTATNÍ NESOUKROMÉ METODY INSTANCÍ ========================================
//== SOUKROMÉ A POMOCNÉ METODY TŘÍDY ===========================================
//== SOUKROMÉ A POMOCNÉ METODY INSTANCÍ ========================================
//== INTERNÍ DATOVÉ TYPY =======================================================

    /***************************************************************************
     * Vnitřní třída, jejíž instance představují posluchače
     * vstupního textového pole čekající na stisk klávesy {@code Enter}
     * v okamžiku, kdy má pole fokus.
     */
    private class TxfListener implements ActionListener
    {
        /***********************************************************************
         * Zjistí aktuální text ve vstupním poli (= text zadaného příkazu),
         * zapíše jej do výstupní oblasti,
         * předá zadaný příkaz obsluhované hře ke zpracování
         * a do výstupního pole zapíše obdržený výsledek.
         *
         * @param e Objekt, který je schopen poskytnout informace o události,
         *          avšak v této verzi není využíván
         */
        @Override
        public void actionPerformed(ActionEvent e)
        {
            String statement = inputField.getText();
            outputArea.append(PŘED_PŘÍKAZEM + statement + ZA_PŘÍKAZEM);
            String answer = game.executeCommand(statement);
            outputArea.append(answer + '\n');
            inputField.setText("");
        }
    }



//== TESTY A METODA MAIN =======================================================

    /***************************************************************************
     * Testovací metoda předvede hraní implicitní hry
     * prostřednictvím zde definovaného GUI.
     */
    public static void test()
    {
        GUI_02_0   gui   = new GUI_02_0(null);
        IGame    gameX = _Test_101.getDefaultGame();
        _Test_101.playGameByScenario(gameX, 2, gui);
    }
    /** @param args Parametry příkazového řádku - nepoužívané. */
    public static void main( String[] args )  {  test();  }
}
